<>-- Dragon from Succubus Valley --<>
(DfSV / Succubus Heart) By : spirit Shard

<> What is the 'Dragon from Succubus Valley' mod? <>
Dragon from Succubus Valley (DfSV for short) is a mod focused on integrating sex with progression. With DfSV installed the player will have the abilities of a life force stealing Succubus! Players will increase stats through sexual activity and be able to sacrifice those stats in order to level up and unlock new skills/spells.


<> Story <>
[spoiler]
<> Dragon from Succubus Valley - Character Story <>
Two rival nations battling for the last of their precious pets. The Succubus army of Blood Heart takes on full assault into Casting Glaze, or as it's known to the humans, Succubus Valley. A lone Succubus resident rises from their victim's body as they hear the gates shatter - they are here for humans. The lone Succubus rushes on her way to warn the commander but is stopped by a large Blood Heart force. "It's over Moon Heart, we're taking them all!" Her once victim dragged alongside her as they headed for the shattered metal gates gives out a whisper, "You... You can help.." The Succubus looks down on the ragged man but is quickly surprised by a glow in his hand, "Help my... my homeland..." In a quick dash of light the man stands as destruction circles the two dragged prisoners, "THIS IS OUR FREEDOM."

The succubus wakes up in the middle of a castle surrounded by what appears to be.. humans? Delighted as she is, it's not long before she's tied up and put into a cell. "Oh well, at least they mistake me for some dragonborn hero."


<> Story - Succubus <>
The Succubus is a creature who gains power through the consumption of souls and Life Force, and the easiest way to get them is through.. oh, you know.. ^.-[/spoiler]


<> Mechanics <>
Succubus Blessing
--- Absorb Max Health/Stamina/Magicka from others during Sex
--- Sacrifice Max Health/Stamina/Magicka to level up
--- Consume delicious sperm for some extra delight
--- [WIP] Sacrifice stats to summon powerful power spells
--- [Planned] Use the power of sperm to conjure destruction
--- [Planned] If you've got the focus, overpower your foes with seduction spells
--- [Possible?] Talk your way to the bedroom with seductive language (Seductive Dialogue)

Heart System
--- Heart Focus system, use this to increase Succubus Spell effects.
--- Obtain HeartXP through sexual activities
--- Spend this HeartXP on advancing your skills
--- Spend HeartXP to expand your succubus powers and learn new spells/seductive ways

Built on SexLab Framework
--- Any sexlab animations will work with this mod

MCM, DfSV - Succubus Heart
--- Spend your points and level skills using the MCM
--- [WIP] Manage settings through the MCM
--- [Planned] Full Help section for references

[Possible?] Dragon from Incubus Canyon
--- Play through the mod with all aspects geared toward a male protagonist (NOTE : current version works for males, just a little strange because of Sperm mechanic)
[Possible?] Sperm Trader
[Possible?] SexLab Arousal integration?
[Possible?] "Succubus Heart" Quest Line
[Improve] Code so that other mods can trigger HeartXP and effect Heart Force (If a modder is interested in this please send me a message and I'll let you know how it works)


<> Requirements <>
- SKSE 1.07.01 [ http://skse.silverlock.org/ ]
--- It may run on an older version but this is what I worked with.
- Sexlab v159c [ http://www.loverslab...dated-oct-3rd/ ]
--- Or higher I assume
- SkyUI 4.1 [ http://www.nexusmods.com/skyrim/mods/3863/? ]
--- Or higher I assume. Needed for MCM.


<> Strongly Recommended Mods <>
- Skyrim -Community- Uncapper [ http://www.nexusmods...im/mods/1175/? ]
--- For uncapping the level caps and adjusting leveling to accommodate for the new progression options. (I provide optional settings for uncapper as well)

<> 'just' Recommended Mods <>
- Defeat V5b3.3+ [ http://www.loverslab...5b33fixed-805/ ]
--- Allows for a whole array of rape and such, plus the tie-up feature really helps out in big fights, or just to let your pet wait a little longer for pleasure. ^.-
- More Nasty Critters [ http://www.loverslab...asty-critters/ ]
--- Large collection and additions to bestiality mods - a must have in my opinion.


<> Recommended Settings <>
()> Skyrim -Community- Uncapper <()
I've provided an ini settings file as optional in order to set a little balance. This file contains a few changes...
-- Increased Caps to 999
-- Sets +5 carry weight to Health, Energy, and Magicka increase
-- Skill Multipliers are set at 0.5
Please adjust these amounts to fit the way you play. If you wish to use the succubus skills as your primary combat function I recommend low skill multipliers, if you only use succubus skills casually I recommend normal skill multipliers. (I'll have different presets at a later date)


<> Compatibility <>
- Conflicts with mods that "lock" stats or increase/decrease them to maintain a specific value, luckly these mods are very rare since there's really no reason to do this..
- Compatibility with PSQ is beginning to be questionable (some features are in both mods but done in different ways, causing play style issues)
- If you find anything else please let me know!

<> Known Issues <>
- Some MCM messages are still in floats (Has no negative effect, I'll fix it eventually)

<> Installation / Updating <>
Merge the provided Data folder with your skyrim install, install 'Optional Uncap' if so desired. Enable in your mod manager of choice.

WARNING : if you have a version before V1.0.0 then a clean save is required for many elements to function properly, a new game is recommended for low level characters. If you had a version before V0.5.0 a new game is highly recommended do to script update changes.

<> Uninstall / Removal <>
Disable the Mod in your mod manager of choice, load up your saved game you wish to uninstall it from, wait at least 10 seconds, save and exit. After this "clean save" you can delete all the files with "DfSV" at the start of the name from Data, Data/Script, and Data/Script/Source. Removing the files is not necessary for updating but is recommended if you had a version before V1.0.0 installed.


<> FAQ <>
[spoiler]
<> Q and A <>
Q : What does Heart Force do? [V0.6.0]
A : Heart Force is used for Succubus Spells and determines their effectiveness.

Q : Why does my character always seem to have XXX health/magicka/stamina?
A : In this mod the succubus gains status when having sex but will lose those gains over time, you'll need to continue sexual activities to keep higher status, may I suggest keeping extra sperm on you? The rate is 1/9sec. The minimum is calculated by 100 + 10/per level.

Q : Why have health/magicka/stamina decay?
A : This is a balancing act to prevent players from amassing large amounts of health at lower levels and to help prevent mass leveling of a single skill. (ex. level 150 Marksman while 15-20 in all other skills)

Q : What is the point when I can just have sex to heal?
A : This mod does not actually heal you! It only effects the max of your health (excluding spells). This means unless your absorption has been increased a good amount you will not actually heal all that much. Also, if you're worried about challenge don't use mods that exploit the systems. Ultimately you're in control of how difficult the game and mechanics are.

Q : When are the dialogue options going to be included?
A : Including things like dialogue is very different than what I've been doing and requires a whole new set of scripts/objects to get working the way I want it. It's also very tedious for a lot of these things, it'll be in a future update but not likely soon, I'd rather get all the main mechanics working before entering the mud pool.
[/spoiler]

<> Spells <>
[spoiler]
[Heart] Focus Shot
--- Consumes 10% of your current Heart Force and damages the target by that amount. 50% of that goes into HeartXP.
[Heart] Dark Pierce
--- Consume 20% of your Health/Magicka/Stamina and damage the target's Health/Magicka/Stamina by that amount. 50% total of that goes into HeartXP

More Spells are on the way
[/spoiler]

<> Change Log <>
[spoiler]
- V1.0.0 [WARNING : With this release a clean save is REQUIRED]
--- Re-write of most script
--- Removed outdated variables and scripts (main reason for clean save requirement)
--- Values now pass through "Math.Floor" (this 'should' mean no more float values)
--- Effects under 1 will now value as 0 (no more slight increases over long durations)
--- Adjusted Spells to have a mana cost (again)
--- Removed Carry weight increase option (being moved into spells later on)
--- Changed "Increase HeartXP" Stat into a percentage
--- *WARNING* because of HeartXP changes HeartXP gain will revert to 100% when updating
--- Completely changed leveling values and requirements
--- Requirements now increase as skills/values increase (base requirements are a lot lower because of this)
--- Changed HeartXP values for actions (they are significantly higher than before)
--- Removed 20 status minimum (you can now lower a status down to 0)
--- Level up messages should now show effect (ex. "Alchemy Increased to 41")
--- "HeartXP" status added to HeartXP MCM
--- Removed extra effects from Sperm (these slots will be filled in a future update
--- *Bug* Some messages will still show float values (no actual negative effect, just visually unappealing)

- V0.7.0
--- *Fixed* Sperm not effecting stats
--- *Adjusted* Sperm values to give more HeartXP
--- *Adjusted* Status Cap to 100 + 15 per level
--- *Fixed* Status values staying at ##1 or ##9
--- (technically a fix) Removed mana cost from [Heart]Focus Shot spell
--- *Fixed* [Heart]Focus Shot should now be a hostile spell
--- *Added* New Spell [Heart]Dark Pierce
--- *Adjusted* absorption rate to 3 seconds
--- *Adjusted* decay rate to 9 seconds
--- *Fixed* attacker and victim adsorption reversing for NPCs

- V0.6.0
--- Heart Force usage changed
--- Heart Force will now be used only for spells and seduction attempts
--- Heart Force is no longer lost during sexual activity
--- Heart Force no longer effects gains/losses during sexual activity
--- New Spell "Force Shot" Added (find it under the Heart Spells MCM)
--- The minimum Health/Magicka/Stamina a player can have before decay is now increased with each player level (100 + 10/per level)
--- Skill Levels are now shown in the Soul Burn MCM (The page must be re-selected for changes to show)
--- Absorb Values are now shown in the Status MCM
--- Sperm values are now shown in the Status MCM
--- *Adjusted* sex type effects (As aggressor - 100% / As Consensual - 60% / As Victim - 10%)
--- *Fixed* Sperm not increasing status by the proper values
--- *Fixed* HeartXP Gain not increasing properly and decaying on some events
--- *Fixed* Heart Gain MCM not increasing properly
--- *Fixed* More improper values (when there's so many lines of code it's easy to miss things X.x)

- V0.5.2
--- Fixed improper labels
--- Minor check adjustments

- V0.5.1
--- The "HeartXP" options should now show a confirmation window like with skills
--- *fixed* being unable to level anything in the HeartXP page
--- *fixed* obsessive damage after sex (should now currently check with only 1 health damage. Reminder, if your partner only has 1 health remaining he/she will die, a more complex death check may be released in the next version)

- V0.5.0 [New Game is recommended - clean save may be enough]
--- Pretty much re-wrote everything
--- Large balance update (changed all values)
--- Changed Lowest Health/Magicka/Stamina the player can have to 20 (So be careful!)
--- The player now decay Health/Magicka/Stamina when over 100
--- Added in Gender Checks (Females should no longer give sperm)
--- All females should now receive sperm when there is a male partner
--- Sperm count increases when multiple males are present in the animation (there's still a chance someone will go dry tho!)
--- Partner Harm now implemented (for victims/aggressors, consensual harm will be available in a later update, the amount is determined by the character's absorption rates)
--- "Status" is now viewable in the Soul Burn MCM (Health/Magic/Energy/HeartXP)
--- High and Low Heart Focus now effect absorption and HeartXP gain at fixed amounts ( 150% on high and 50% on low )
--- You can now increase Absorption rate of Health/Magicka/Stamina in the MCM with HeartXP
--- You can now increase HeartXP gain in the MCM with HeartXP (a little ironic, I know)
--- You can now increase sperm effects in the MCM
--- A lot of "under the hood" improvements
--- *Removed* "Uninstall" option until I learn how to add it properly
--- *Removed* "Random Knowledge" Soul Burn effect
--- *Removed* "Soul Burn" Spells from .esp (they were outdated and not available by normal means anyway)
--- *Altered* Optional uncapper options (contains skills uncapped to 999 and skill multi at 0.4 for balance concerns)
--- *fixed* an issue with script updates and broken saves
--- *fixed/removed* "I feel a little weak..." debug spam when Heart Force is low
--- *fixed* females giving sperm
--- *Fix* Sperm's "Succubus Delight" effect now only works on the player as intended

- V0.4.1
--- [hopefully] Fixed Heart Force getting 'stuck' under zero
--- Fixed "Feeling a little weak..." from spamming console even when Heart Force isn't low
--- "Status" Screen now shows appropriate values (still in float form tho)

- V0.4.0 [Clean Save Required]
--- MCM menu has been added! (DfSV - Succubus heart)
--- New Status Menu Page in MCM
--- Soul Burn now available through MCM
--- Can now level individual skills at increased cost
--- Can now Increase Carry Weight just like a Skill
--- Added New HeartXP Mechanic (gained through sexual activity)
--- You can now spend HeartXP for individual skill ups
--- Added New Heart Force Mechanic (this replaces the plan for stamina effects to avoid conflicts with other mods)
--- Heart Force passively regenerates but decreases through sexual activity
--- You can now increase Max Heart Force and the regen rate of Heart Force with HeartXP
--- Heart Force now effects the benefits of sexual activity (being raped will lower it quicker than raping another)
--- Added a "player submit" effect for when the player is victim
--- Added chances to get a large load of sperm, or a dry run...
--- *Fixed* compatibility issue with health/stamina/magicka buffs
--- Added an "Uninstall" option under settings to stop quest scripts after uninstallations (doesn't work fully)
--- *Adjusted* optional uncapper settings
--- *Removed* Soul Burn spells from quest start-up (You can still find them using the console since they may return but their effects have not been updated to align with the new MCM options)
--- NOTE : Spells will be added as an option in the MCM on a later update if requested enough

- V0.2.0 [Clean Save Required]
--- SexLab Integration
--- Removed the need for SexLabUtil1 (if you were using V0.1.3 please disable the DfSV settings in SexLabUtil1)
--- With SexLabUtil1 gone there are no longer any required settings before play, just install and go!
--- Player now Gain stats during sex
--- Player now Gains bonus stats for being an Aggressor
--- Added Visuals to the "Soul Burn" skills (still lacks casting effect and menu image)
--- Sperm is now efficiently added (no more double sperm gain!)
--- *Broke* harm to opponent durring sex (you can use SexLabUtil1 if this is a needed feature)
--- *Adjusted* Sperm stat values (now that you gain stats during sex)
--- *Adjusted* and fixed a few Soul Burn effects (May need further adjustments)
--- *Adjusted* Optional uncapper settings to be closer to vanilla (now only uncaps all skills to 999 and reduces level multipliers to 0.8)

- V0.1.3
--- Concept Release
[/spoiler]

If you guys/gals have any ideas or want to help go ahead and say so! I'm fairly new to Papyrus so there's quite a bit I can learn and I'm always looking for new ideas.

Happy Hunting!